home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 November / Chip Kasım 1999.iso / program / astr / sky2.exe / README.TXT next >
Encoding:
Text File  |  1996-10-28  |  12.1 KB  |  251 lines
  1.  
  2.                      Sky Screen Saver for Windows
  3.                                                 
  4.                       Version 2.1 Release Notes
  5.                 by John Walker -- kelvin@fourmilab.ch
  6.                WWW home page: http://www.fourmilab.ch/
  7.                                     
  8. INTRODUCTION
  9. ============
  10.  
  11. The Sky Screen Saver shows the sky above any location on Earth,
  12. including stars (from the Yale Bright Star Catalogue of more than 9000
  13. stars to the 7th magnitude), the Moon in its correct phase and
  14. position in the sky, and the position of the Sun and all the planets
  15. in the sky.
  16.  
  17. Outlines, boundaries, and names of constellations can be displayed, as
  18. well as names and Bayer/Flamsteed designations of stars brighter than
  19. a given threshold.  A database of more than 500 deep-sky objects,
  20. including all the Messier objects and bright NGC objects can be
  21. plotted to a given magnitude.  The ecliptic and celestial equator can
  22. be plotted, complete with co-ordinates.
  23.  
  24. To fulfill its mission as a screen saver, the sky map shifts position
  25. on the display every 10 minutes to avoid burning in those few
  26. components of the display which do not move as the Earth revolves.
  27.  
  28. The Sky Screen Saver is in the public domain.  You can do anything you
  29. like with it.
  30.  
  31. INSTALLATION
  32. ============
  33.  
  34. To install the Sky Screen Saver, obtain the archive SKYSCR32.ZIP
  35. and extract the files from it with PKUNZIP.  You will obtain:
  36.  
  37.     SKY.SCR         - Screen saver module
  38.     README.TXT      - This document
  39.                 
  40. Copy SKY.SCR to your Windows directory (usually C:\WINDOWS for
  41. Windows 95, or c:\WINNT\SYSTEM32 for Windows NT), then from the
  42. Desktop option of the Control Panel, choose "Sky" as your
  43. screen saver and use "Setup" to configure it for your location and
  44. preferences.
  45.  
  46. CONFIGURATION
  47. =============
  48.  
  49. In order to correctly display the sky above your location on Earth,
  50. the Sky Screen Saver needs to know the latitude and longitude of your
  51. location.  Specify this information as follows:
  52.  
  53. Latitude and Longitude
  54. ----------------------
  55.  
  56. The latitude and longitude are specified in the dialogue which appears
  57. when you click the "Setup" button in the Screen Saver section of the
  58. Desktop control panel option.  Enter your latitude and longitude, in
  59. degrees, minutes, and seconds in the boxes, and don't forget to click
  60. the buttons to specify whether your latitude is North or South and
  61. your longitude East or West.
  62.  
  63. Don't worry about getting the longitude and latitude absolutely
  64. precise for your location--a couple of minutes of error don't make
  65. much difference in the appearance of the sky rendered at this scale.
  66.  
  67. You don't have to enter your own latitude and longitude; you can enter
  68. the co-ordinates of any point on Earth and see the sky as it appears
  69. from that location.
  70.  
  71. Detailed Configuration
  72. ----------------------
  73.  
  74. The "Detailed Configuration" button displays a dialogue which allows
  75. you to enable or disable the display of various components of the sky
  76. map.
  77.  
  78.     Constellations:
  79.         Outlines                -- The lines connecting the principal stars
  80.                                    of the constellations.
  81.         Boundaries              -- The boundaries astronomers have defined
  82.                                    between the constellations.
  83.         Names                   -- Constellation names.
  84.              Align              -- Rotate constellation names to align
  85.                                    with horizon on the map.  This requires
  86.                                    generation of a separate TrueType font
  87.                                    for each constellation name.  On a fast
  88.                                    '486 with plenty of memory, it adds only
  89.                                    a few seconds to the generation time,
  90.                                    but on a 20 Mhz '386 with limited
  91.                                    memory, it can take minutes.  This mode
  92.                                    is off by default; try it to see how
  93.                                    long it takes and whether you prefer the
  94.                                    names aligned.
  95.             
  96.     Stars:
  97.         Magnitude limit         -- Stars dimmer than this magnitude will
  98.                                    not be displayed.  Set to 6 to show all
  99.                                    naked-eye stars.
  100.         Names                   -- Check box to display names (e.g. "Vega",
  101.                                    "Sirius", "Canopus") of stars brighter
  102.                                    than the given magnitude limit.
  103.         Bayer/Flamsteed codes   -- Check box to display Bayer greek
  104.                                    letters and Flamsteed numbers for stars
  105.                                    brighter than the given magnitude.  These
  106.                                    are the designations of stars within a
  107.                                    constellation such as "Delta Pavonis" or
  108.                                    "61 Cygni".
  109.                                                
  110.     Deep sky objects            -- Check box to plot deep sky objects
  111.                                    (galaxies, gaseous nebulae, star
  112.                                    clusters, etc.) brighter than the
  113.                                    specified magnitude.
  114.                                                
  115.     Show ecliptic, equator, poles -- If checked, the celestial north
  116.                                      and south poles will be marked with a
  117.                                      cross whose arms point in the
  118.                                      direction of the equinoctial and
  119.                                      solstitial colures, and the ecliptic
  120.                                      (labeled every 15 degrees) and the
  121.                                      celestial equator (labeled in hours of
  122.                                      right ascension) will be plotted.
  123.                                                
  124.     Show solar system objects   -- If checked, the Sun, Moon, and planets
  125.                                    will appear in the sky map.
  126.                                                
  127.     Show calculation time       -- Check box to display the time required
  128.                                    to calculate each update to the sky
  129.                                    map.  This is primarily intended for
  130.                                    benchmarking various machines.
  131.  
  132. DID YOU NOTICE?
  133. ===============
  134.  
  135. The colour of the legends around the map changes based on the Sun's
  136. altitude.  When it's nighttime (Sun more than 18 degrees below the
  137. horizon), they're grey.  During the day (sunrise to sunset), they're
  138. bright blue.  During dawn and sunset (when the Sun is between 1 and 6
  139. degrees below the horizon) the legends are dark red, and during the
  140. balance of twilight (Sun between 6 and 18 degrees below the horizon),
  141. they're dark blue.
  142.  
  143. For locations in the northern hemisphere the map is plotted with North
  144. at the top, while observers in the southern hemisphere see South at
  145. the top.  East and West flop also, following the convention for
  146. printed star maps.  Note than since a star map represents the dome of
  147. the heavens and is used, at least mentally, by holding it up over your
  148. head, East and West are reversed with respect to a map of the Earth.
  149.  
  150. HOME PLANET
  151. ===========
  152.  
  153. The Sky Screen Saver was developed based on Home Planet, a
  154. comprehensive Earth and sky simulator for Windows which displays the
  155. Earth, tracks satellites, asteroids, and comets, includes an
  156. extensible multimedia object catalogue, a simulated telescope for
  157. viewing the sky at any magnification or location, a database of more
  158. than a quarter million stars, and a complete hypertext help file and
  159. introduction to astronomy linked to the components of the program.
  160. Displays include the illuminated portion of the Earth, the Sky, the
  161. Telescope, the Earth as viewed from a satellite, the Moon, or the Sun,
  162. an orrery, panels displaying current information about the Moon and
  163. planets, and more.  Real-time astronomical information can be exported
  164. to other applications via DDE.  There's even a cuckoo clock (you can
  165. turn it off).
  166.  
  167. Home Planet is in the public domain; you can do anything you like with
  168. it.
  169.  
  170. For more information about Home Planet, visit the World-Wide Web page:
  171.  
  172.     http://www.fourmilab.ch/homeplanet/homeplanet.html
  173.     
  174. UPDATE LOG
  175. ==========
  176.  
  177. Version 1.0 (19 Sep 1994):  Initial release.
  178.  
  179. Version 1.1 (27 Sep 1994):  If the allocation of the device dependent
  180. bitmap in which the sky map is drawn failed, several GDI calls were
  181. made with a zero handle.  This caused warning messages and resulted in
  182. a blank screen with only the time at the top.  I added code to detect
  183. the failed allocation and display an out of memory message which moves
  184. around the screen every 10 seconds.  The size of the bitmap depends
  185. upon the size and colour depth of the configured display, so it's hard
  186. to give general guidelines about how much free memory is required.  With
  187. a 1024x768x16 display, 2 megabytes free RAM is plenty.  A 1024x768 full
  188. colour (24 bit per pixel) display requires about 5 megabytes of free RAM
  189. to allocate the bitmap and other storage.
  190.  
  191. (17 Sep 1994):  Built a version of 1.1 with the "alternate math package"
  192. to work around coprocessor emulation bugs.  Tested both on a 486DX50 and
  193. a 386/20 with no coprocessor.  It worked fine on both.
  194.  
  195. (11 April 1996):  Ported to Windows 95 and updated version to 2.0.  Since
  196. Windows 95 handles screen saver passwords itself, I ripped out all the
  197. password machinery needed on Windows 3.x.  Since the AccessResource
  198. API call which I used to conserve memory on 16 bit Windows has been
  199. conveniently ripped out in Win32, I added openRES(), fgetsRES(), and
  200. closeRES() functions to provide access to text files emebedded in
  201. resources.
  202.  
  203. Deep sky objects weren't working because the format used to scan the
  204. items in the database was accidentally deleted.  Fixed.
  205.  
  206. (12 April 1996): Added the new identity string as the first item in
  207. the string table.  It doesn't seem to be used for anything, but it's
  208. there anyway.
  209.  
  210. The application name wasn't getting loaded by GetIniEntries(),
  211. resulting in a blank section name in CONTROL.INI--this seems to have
  212. been done in the screen saver library on Windows 3.x, but you have to
  213. do it yourself on Win 32.
  214.  
  215. In the spirit of such great Microsoft contributions to the art of
  216. computer science such as IsTextUnicode() (look it up), I added a
  217. "longitude and latitude guesser" to SCRNSAVE.C's GetIniSettings()
  218. which is invoked when the user has not entered a latitude and
  219. longitude in the configuration box.  The latitude is guessed based
  220. on the time zone bias--15 degrees for each hour.  The latitude is
  221. set to either 45 North or 45 South based on the following algorithm.
  222. If the time zone uses Daylight time, the latitude is North if the
  223. switch to daylight time occurs in the first 6 months of the year
  224. and South if in the second 6 months.  If Daylight time is not used
  225. in the zone, North is used unless the time zone name begins with
  226. "SA " or contains the string "South ".  This is incredibly hokey,
  227. but works rather well and should reduce the number of bozo E-mails
  228. from people who want me to look up their latitude and longitude
  229. or wondering why the sky is wrong when they never bothered to set
  230. their site location in the first place.
  231.  
  232. Added code to check the fChildPreview flag, set if we're being run
  233. by the Control Panel on-the-fly preview.  If so, the sky image
  234. parameters are tweaked to produce something vaguely reasonable
  235. in the preview window.
  236.  
  237. Bounds Checker pointed out we weren't destroying the Moon icon
  238. allocated in SUNMOON.C at program exit time.  Fixed.
  239.  
  240. Removed some unused code and variables in PROJECT.C, not needed since
  241. the screen saver only makes stereographic projections.
  242.  
  243. Release 2.0.
  244.  
  245. (October 28, 1996): I discovered I was a little overzealous in ripping
  246. out the old tzset()/time() code when installing the Windows 95 time
  247. zone facility, and accidentally disabled the timer which makes the
  248. sky map shift position on the screen every 10 minutes.  Fixed.
  249.  
  250. Release 2.1.
  251.